home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / opalvisn / ovline11.lzh / ovgif.doc next >
Encoding:
Text File  |  1993-02-23  |  4.3 KB  |  114 lines
  1. /*  OVGIF  ----  GIF Viewer for Opalvision    ------- 
  2.     Copyright 1992 Jim Boros, all rights reserved.
  3.     Version 0.80  December 12, 1992  
  4.      */
  5.     
  6.       
  7.  
  8.     
  9. I:  INTRODUCTION:
  10.  
  11.     While the OpalVision system is a fantastic display card and paint program 
  12. for the Amiga, it currently lacks support for GIF format images.  It is often
  13. desirable to view GIF images, often those imported from other platforms via
  14. disk, BBS, or even CD-ROM.  I decided to write a simple loader for this purpose. 
  15. With OpalVision and ovgif, you can view all those colo(u)rful pictures on
  16. your Amiga.
  17.  
  18.  
  19. II: DESCRIPTION:
  20.  
  21.     OVGIF loads in a GIF87a format file, decodes it, and displays it on the
  22. OpalVision Screen.  Its memory usage depends on the size of image being loaded.
  23. It opens three large memory arrays besides its working area ( around 100K). 
  24. The first is the size of the file to load the compressed data, then it allocates
  25. another area to place the uncompressed (Raster) data in, this is the Height
  26. times Width, one byte per pixel.  Then it releases the first (disk ) buffer
  27. and allocates a virtual OpalVision screen in memory.  An 8 bit, Palette mapped
  28. mode is always used, as the GIF format uses up to 256 registered colors, and
  29. this uses a third of the memory of the  24 Bit screen.  
  30.     Because image sizes and depths vary widely, this program centers the image
  31. in the display.  A small image will appear in the center, and have the outer 
  32. parts of the screen filled in with a plain color.  An oversized image will be
  33. centered, with both extremes going off the screen.  I found this better than
  34. the upper left justification.  Most images I've encountered are 640X480 and
  35. all but the top and bottom few lines are visible.
  36.     It supports GIF87a images in any color depth up to 8 bit (256 colors), and
  37. size within memory limits.  This version is written in SAS C 6.1 and is optimized
  38. as much as possible.  It is slightly faster than the JPEG loads, but not as
  39. fast as an IFF24 or OVFAST.  If interest is sufficient, the decompression code
  40. will be rewritten in assembly.  On an Amiga 2000 with a GVP 030 board, it takes
  41. approximately 15 seconds to load a 640x480x256 color GIF.  Smaller images take
  42. less time, as low as 3-5 seconds.  
  43.  
  44. III: REQUIREMENTS:
  45.  
  46.     OpalVision Board.
  47.     
  48.     Amiga 2000 to 4000 with 2Meg of Ram.
  49.     
  50.     Accelerator strongly recommended.
  51.  
  52.      
  53. IV:  USE:
  54.  
  55.     This is simple to use, it can be called from the CLI or Shell by typing
  56. "ovgif" followed by the filename (including .gif).  It may also be launched
  57. as a task from a directory utility such as SID 2.0. It is best to click on
  58. single files instead of whole groups.  
  59.     The window will display some data about the picture and how long it took
  60. to load ( this mainly for my development).  Then the image is displayed.  
  61. To close, click the left mouse button. 
  62.     At this release level, no set contribution is requested.   If you find
  63. this program extremely useful and use it regularly, feel free to send a 
  64. small donation.  For any donation over five dollars, I'll send a disk with
  65. some other useful Opalvision programs, and pictures.  The more people respond
  66. in this manner, the more features on the list below will be added, and I will
  67. write more utilities like this.  
  68.  
  69.                 Send Contributions and Bug reports to:
  70.                 
  71.                     Jim Boros C/O
  72.                     Borotec
  73.                     PO Box 17149
  74.                     Euclid,  Ohio  44117
  75.                     
  76.  
  77. VII: DISCLAIMER:
  78.     
  79.     This software is distributed without warranty of any kind.  Neither Jim 
  80. Boros, Borotec, any associates or employees, or other parties will be liable
  81. for any loss of data, hardware,or any lost productivity and any damages relating
  82. therefrom.  
  83.     
  84. VIII: TO DO LIST:
  85.  
  86.     1)  Add Scrolling for oversized images.
  87.     
  88.     2)  Put a save feature to save image in OpalVision supported formats.
  89.     
  90.     3)  Support for GIF89a type images.
  91.     
  92.     4)  Ability to "Stamp" image in as a backdrop to WorkBench.
  93.     
  94.     5)  Recode some or all of the decoding routines in assembler.
  95.     
  96. IV:   TRADEMARKS:
  97.  
  98.  
  99. OpalVision is a trademark of Opal Technology Pty Ltd.
  100.  
  101. Amiga and WorkBench ar trademarks of Commodore-Amiga Inc.
  102.  
  103. SID is a program written by Timm Martin.  
  104.   This is very worthwile shareware.
  105.   
  106.   
  107.       
  108.   
  109.   
  110.  
  111.                                          
  112.  
  113.             
  114.